STIMP_noise: Anleitung

bin
bin.030882
bin.ppc
doc
help
Ultraconv
Assign.Skript
doc.info
Install
Install.info
STIMP_noise.readme

Verzeichnis bin/

pgmbinomial
pgmlulu
pgmmaximin
pgmmean
pgmmedian
pgmminimax
pgmoutlier
pgmpseudomedian
pgmrank
pnmaddnoise
pnmimpnoise
pnmwhitenoise
ppmadapmedian
ppmcolmedian
ppmvecmedian

Verzeichnis bin.030882/

pgmbinomial
pgmlulu
pgmmaximin
pgmmean
pgmmedian
pgmminimax
pgmoutlier
pgmpseudomedian
pgmrank
pnmaddnoise
pnmimpnoise
pnmwhitenoise
ppmadapmedian
ppmcolmedian
ppmvecmedian

Verzeichnis bin.ppc/

pgmbinomial.elf
pgmlulu.elf
pgmmaximin.elf
pgmmean.elf
pgmmedian.elf
pgmminimax.elf
pgmoutlier.elf
pgmpseudomedian.elf
pgmrank.elf
pnmaddnoise.elf
pnmimpnoise.elf
pnmwhitenoise.elf
ppmadapmedian.elf
ppmcolmedian.elf
ppmvecmedian.elf
runelf

Verzeichnis doc/

gfx
noise.deutsch.html
noise.deutsch.html.info
noise.english.html
noise.english.html.info

Verzeichnis doc/gfx/

d.gif
gb.gif

Verzeichnis help/

pgmbinomial.syntax
pgmlulu.syntax
pgmmaximin.syntax
pgmmean.syntax
pgmmedian.syntax
pgmminimax.syntax
pgmoutlier.syntax
pgmpseudomedian.syntax
pgmrank.syntax
pnmaddnoise.syntax
pnmimpnoise.syntax
pnmwhitenoise.syntax
ppmadapmedian.syntax
ppmcolmedian.syntax
ppmvecmedian.syntax

Verzeichnis Ultraconv/

Catalogs
ReqDesc
AddNewFilters.Skript
AddPPCSupport.Skript
Filters.new
PPCBin.new

Verzeichnis Ultraconv/Catalogs/

Deutsch

Verzeichnis Ultraconv/Catalogs/Deutsch/

STIMP_noise.catalog

Verzeichnis Ultraconv/ReqDesc/

AddNoise
ImpNoise
Outlier
Rank3
Rank5
WhiteNoise

Sollte eine der Dateien fehlen, holen Sie sich besser eine vollständige Version, am besten gleich von meiner Homepage.

COPYRIGHT

Alle in diesem Archiv enthaltenen Dateien unterliegen dem Copyright, d.h. (c) Stefan Diener. Es ist nicht gestattet,

dieses Archiv zu verändern und die modifizierte Form in Umlauf zu bringen (Insbesondere ist es nicht gestattet, diese Notiz zu entfernen !),
die Programme und Quelltexte oder Teile davon zu kommerziellen Zwecken zu nutzen,
das Archiv oder Teile davon einem kommerziellen Programm(-paket) beizulegen.

Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung !

Notiz: Dieses Archiv (bzw. eine ältere Version davon) können Sie auf der UConv4-CDROM finden, die von RBM Computertechnik Bernd Rudolf produziert wird. Felix Schwarz (Autor von Ultraconv) hat die Erlaubnis erhalten, dieses Archiv zusammen mit UConv Version 4 zu veröffentlichen.

Abgesehen von obigen Einschränkungen dürfen das Programm und die Quelltexte jedoch nichkommerziell frei verwendet werden. Sollte ein Quelltext oder ein Teil davon in einem anderen Programm verwendet werden oder ein bestehendes Programm auf diese Weise weiterentwickelt werden, so ist sowohl im neuen Quelltext, als auch im neuen Programm ein Hinweis auf den ursprünglichen Autor zu vermerken. Ich würde mich darüber freuen, in diesen Fällen etwas von den Entwicklungen zu erfahren, d.h. ich bitte darum, mir wenigstens eine kurze E-Mail zu schicken.

Der Autor behält sich vor, die Copyright-Bedingungen in späteren Versionen zu ändern.

GARANTIE

Ha, ein Scherz ! Keine Garantie ! Es gibt weder eine Garantie darauf, daß das Programm auf Ihrem Rechner läuft, noch darauf, daß das Programm den angegebenen Zweck erfüllt. Und es übernimmt auch niemand irgendeine Haftung für Schäden, die an Ihrem Rechner durch sachgemäße oder unsachgemäße Benutzung des Programms entstehen. Es kann nicht dafür garantiert werden, daß die Bildschirmausgaben, die das Programm erzeugt, auch korrekt sind. Auch hier keine Haftung. Sollten Sie dieses Programm benutzen, so tun Sie das auf eigenes Risiko.

ABER: Es wurde mit Nachdruck daran gearbeitet, das Programm möglichst von allen Fehlern zu befreien und es wurde ein erheblicher Aufwand auf das Testen des Programms verwendet. Die Chance, daß das Programm unentdeckte Fehler enthält, besteht jedoch weiterhin.

VERSION

Diese Anleitung bezieht sich auf die Version 1.04 des Programmpaketes. Die Versionsnummern der einzelnen Programme entnehmen Sie bitte der entsprechenden Progammdokumentation. Sollten Sie eine neuere Version des gesamten Archivs besitzen, können Sie diese Datei getrost vergessen.

AUFRUF

Dieses Archiv und alle darin enthaltenen Programme dürfen Sie kostenlos benutzen (siehe Abschnitt "Copyright"). Sie sollten aber daran denken, daß viel Zeit in die Erstellung der Programme und der Dokumentation geflossen ist. Ich erwarte für die Benutzung der Programme kein Geld (wie bei Shareware etwa üblich), würde mich aber über eine kurze Rückmeldung Ihrerseits freuen. Schauen Sie doch auf meiner Homepage vorbei und füllen Sie das Formular auf der Support-Seite aus. Sollten Sie Interesse haben, können Sie auch eine Mailing-Liste abonnieren (nur keine Angst - eine spätere Abbestellung ist problemlos möglich !). Dann werden Sie auch in Zukunft über Weiterentwicklungen und Neuerscheinungen informiert.

Notiz: Zukünftige STIMP-Pakete werden Shareware sein !

INSTALLATION

Benutzen Sie einfach das Installer-Skript "Install", um das Programmpaket automatisch installieren zu lassen.
Selbstverständlich können Sie die Installation auch per Hand vornehmen. Sie tun dies aber auf eigenes Risiko ! Ich habe leider keine Zeit, alle Installationsschritte einzeln zu erkl�ren, da die Installation dazu zu umfangreich geworden ist, leider.

PROGRAMMSTART

Haben Sie die Installation erfolgreich durchgeführt, starten Sie ein Programm Ihrer Wahl OHNE die Angabe von Parametern, z.B. "pgmmedian". Jetzt sollte ein Hilfstext erscheinen. Bekommen Sie stattdessen die Meldung "helpfile not found", ist bei der Installation etwas schief gelaufen. (Haben Sie ev. vergessen, einen Reset durchzuführen ?)

Hinweis: Die Option "-?" wird nicht mehr unterstützt.

Die Hilfstexte sollten nun zur Benutzung der Programme eigentlich ausreichen. Die Bedeutung der jeweiligen Optionen ist dann in der Dokumentation der einzelnen Programme nachzulesen.

Noch kurz zu den verwendeten Symbolen in der Syntax-Zeile:

Eckige Klammern bedeuten, daß dieser Parameter optional ist, d.h. auch weggelassen werden kann.

Senkrechte Striche bedeuten ein exklusives ODER, d.h. von allen Parametern, die hintereinander durch senkrechte Striche verbunden sind, kann nur einer gewählt werden.

"default" bedeutet voreingestellter Wert, d.h. wenn Sie diesen optionalen Parameter weglassen, wird automatisch der voreingestellte Wert angenommen.

Zahlenwerte sind unmittelbar hinter dem einleitenden Buchstaben des Parameters anzugeben, z.B. richtig: "-f32", falsch: "-f 32".

Jeder Parameter muß sein eigenes "-" oder "+" besitzen. Das Zusammenfassen von Parametern ist nicht möglich.

Folgerung: Es können keine Dateinamen verwendet werden, die mit einem "-" oder "+" beginnen. Auch die Verwendung von Anführungszeichen oder Hochkommas bringt nichts. Diese Einschränkung sollte aber im allgemeinen nicht allzu gravierend sein. Tip: Verwenden Sie ein Utility, das die Verzeichnisse "." und ".." nutzbar macht (z.B. UnixDirs) und setzen Sie "./" vor den Dateinamen, der mit "-" oder "+" beginnt. Dann geht´s.

Werfen Sie auch einen Blick auf den folgenden Abschnitt "Umleitungen" !

NUR FüR PPC-BENUTZER: Wenn Sie eine PowerPC-CPU benutzen sind ein paar Kleinigkeiten zu beachten. Benutzen Sie bitte die Programme mit der Endung ".elf" und starten Sie diese Programme mit dem Kommando "runelf", z.B.: "runelf pgmmedian.elf <...Parameter...>".

UMLEITUNGEN

Ein neues Feature ist die Möglichkeit der Eingabe- und Ausgabeumleitung. Zu beachten ist nur, daß der (nun nicht mehr benötigte) Dateiname durch einen "-" zu ersetzen ist. Einige Beispiele:

normalerweise:
"pgmmedian lena.pgm result.pgm"
(wobei lena.pgm Eingabedatei und result.pgm Ausgabedatei ist)
Ausgabe-Umleitung:
"pgmmedian lena.pgm - >result.pgm"
Eingabe-Umleitung:
"pgmmedian - result.pgm <lena.pgm"
Eingabe- und Ausgabe-Umleitung:
"pgmmedian - - <lena.pgm >result.pgm"
Benutzung von Pipes (Grüße von UNIX):
"pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
oder noch komplizierter mit 2 Pipes:
"pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
(Beachte: Um die Eingabe-Umleitung des Programms pnmview benutzen zu können, benötigen Sie eine neuere Version als 0.01ß ...)

Dieses Feature wurde hauptsächlich für die Benutzung von Ultraconv zur Verfügung gestellt, ist aber bei der Programmbenutzung in UNIX ebenfalls sehr nützlich.

Beachte: Man benötigt zusätzliche Software für Pipes beim AmigaOS.

EINSCHRÄNKUNGEN

Die Dateien mit den Kennungen P1, P2 und P3 werden nicht unterstützt. Es handelt sich dabei um die Text-Versionen von PBM, PGM und PPM. Aber keine Angst: die binären Versionen von PBM, PGM und PPM (Kennungen P4, P5 und P6) werden unterstützt und sind ohnehin die gängigeren Dateiformate. Die Text-Versionen verschlingen unnötig viel Speicherplatz, d.h. die Dateien sind größer und das Laden/Speichern dauert entsprechend länger. Da alle Programme des NetPBM-Paketes sowieso die binären Versionen erzeugen, wird man in der Praxis wohl nur selten etwas mit den Text-Versionen zu tun haben. Ich habe mich deshalb entschlossen, mir den Aufwand zum Implementieren der Text-Versionen zu sparen. Wer trotzdem darauf Wert legt, kann ja die Quelltexte des NetPBM-Paketes studieren ...

QUELLTEXT

Ich habe versucht, den Quelltext und die Include-Dateien so gut wie möglich zu kommentiren. An dieser Stelle möchte ich nicht die gesamten Quelltexte erklären (dazu fehlt einfach die Zeit), da ich meine, daß die Kommentare zum Verständnis der Programme ausreichen. Wie auch immer, ich werde in naher Zukunft eine Beschreibung der Include-Dateien veröffentlichen. Es wird sich also um ein sogenanntes "developer release" handeln und ist für alle gedacht, die mit STIMP eigene Programme schreiben wollen. Wie Sie vielleicht bereits gemerkt haben, brauchen Sie sich dann nicht um Dateioperationen zu kümmern, sondern müssen nur den eigentlichen Algorithmus zur Bildtransformation programmieren ... Ich empfehle, einen Blick auf meine Homepage zu werfen und sich in der STIMP-Mailingliste einzutragen ...

Notiz: Die Quelltexte sind seit dieser Version nicht mehr beigelegt. Wenn Sie sich für ein zukünftiges STIMP-Paket registrieren lassen, erhalten Sie neben der Entwickler-Dokumentation auch die Quelltexte zu diesem Paket. Grund: Zukünftige Pakete werden SHAREWARE sein !

WAS IST STIMP ?

Wenn Sie den Abschnitt zur Installation gelesen haben, werden Sie sich sicher fragen, warum gerade die Abkürzung STIMP verwendet wurde. Nun, STIMP steht für "STefan´s IMage Processing". Ich gebe zu, kein wirklich origineller Name. Aber irgendein Name mußte eben her.

ENTWICKLUNGSUMGEBUNG

Compiler:

MaxonC++ 4.0 Light (05.11.96), Maxon Computer GmbH

Computer:

AUTOR

Name : Stefan Diener
E-Mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
Adresse : Wilhelmstr. 7, D-73433 Aalen, Deutschland